home *** CD-ROM | disk | FTP | other *** search
/ Aminet 13 / Aminet 13 - August 1996.iso / Aminet / game / hint / Kdb_ed.lha / KDB_ED.doc < prev    next >
Text File  |  1996-05-19  |  5KB  |  102 lines
  1. Sunday 19. May 1996
  2. (C) JIPsoft
  3.  
  4.  
  5.  
  6.  
  7.                         Kingdom - Board Editor
  8.                           The Documentation
  9.                         ======================
  10.             (Kingdom is (C) 1996 Dave Marsupial Alderson)
  11.  
  12.  
  13.     1. Introduction
  14.  
  15. A couple of weeks ago, I downloaded the game Kingdom (by Dave Alderson) from
  16. AmiNet. I tried it, and saw it was good. Then, I decided to play around with
  17. the board files. I soon found out the structure of the files.
  18.   As a matter of fact, what surprised me is that Dave had programmed the way
  19. that the pieces depend on the bytes in the file to be quite logical, yet
  20. jumbled somewhat. If this is an attempt of encryption on Dave's part, why did
  21. he stop there? Surely he could have done a XOR'ing with a randomly-selected
  22. series of bytes, like Selwyn Stevens (author of Croak 2) did. And if it isn't,
  23. why didn't he just do a normal "1 byte equals 1 piece" array? This puzzles me.
  24.   Anyway, I decided to make an editor program for these files, just to show
  25. Dave to be more careful when saving his data in the future. Oh, and of course
  26. to add to your Kingdom-playing pleasure as well.
  27.   Notice that this editor is in no way connected to the official Kingdom board
  28. editor by Dave Alderson. So this is not a pirate distribution, but entirely
  29. legal, I think.
  30.  
  31.  
  32.     2. Using the Editor
  33.  
  34. As soon as you start the program, you will notice that it has been written in
  35. AMOS. There, that will keep monsieur Lionet happy.
  36.   Anyway, what you will see is a 19*19 square board, a selection of 16 Kingdom
  37. pieces, and a lot of buttons. I will now tell you what all these buttons do.
  38.   Notice that if the program displays "(Y/N)" in the message area, you actually
  39. have to press Y or N. So your machine hasn't crashed yet.
  40.  
  41.  
  42.     3. Drawing on the board
  43.  
  44. To actually put something on a board, first select your pieces from the piece
  45. selection grid in the top right corner. Notice that you can use both mouse
  46. buttons, just like in DPaint. The last piece, which looks like a cross between
  47. a King and a Rook, is a Castle. In Kingdom, Rooks and Castles look the same. In
  48. this program, they don't.
  49.   Then select your drawing instrument, and click on the board. With some
  50. instruments, you have to click twice before you see the changes: once for the
  51. start, and once for the destination.
  52.   The Auto-Reflect toggle will, when activated, automatically make sure that
  53. every piece you put on the board is mirrored on the opposing side of the board.
  54. This is handy when you are making a symmetrical board.
  55.   I will document the rest of the buttons in the next chapters.
  56.  
  57.  
  58.     4. Saving and loading
  59.  
  60. The save and load buttons do just that. Surprise, surprise. You will be
  61. presented with a file requester, so just select the file you want. The program
  62. will then save/load a Kingdom board file according to Dave's file format.
  63.   If you are loading a file, make sure it exists, of course. And if you are
  64. saving a file, take care when overwriting a file. The program will ask you for
  65. confirmation if you save a file that already exists.
  66.   Oh yeah, and the filenames should always end with ".kdb".
  67.  
  68.  
  69.     5. Checking Kings, Credits and Quitting
  70.  
  71. Dave has been a bit strict when it comes to dealing with Kings and Castles on
  72. the board. Each side must have one, and only one, King or Castle.
  73.   So if you have lost count of the Kings/Castles on board, just press Check
  74. Kings. The program will go through the board, checking the amount of Kings and
  75. Castles on either side. And if it finds more than one, it will even remove the
  76. rest for you. Handy, isn't it?
  77.   The Credits button will display the program's credits, and the quit button
  78. will... erm... quit.
  79.  
  80.  
  81.     6. Last words
  82.  
  83. I know I'm robbing Dave's bread by programming and distributing an editor for
  84. Kingdom board files, so Dave won't get so much money from his official editor.
  85. So to make amends, I hereby give Dave Megalomania Alderson full rights to make
  86. any editors for my (JIPsoft's) games, and charge as much money as he likes for
  87. them.
  88.   This offer also concerns Christian Mumenthaler (author of Colonial Conquest
  89. II), but it doesn't concern anybody other people than me, Dave and Christian.
  90. So if you are one of the 4'999'999'997 people that are not any of us three, you
  91. are not allowed to make editors for my games. So there.
  92.   Well anyway, I think it's time I mentioned my address and went home. My
  93. address is:
  94.  
  95.         Joona Palaste
  96.         Toppelundintie 3B 19
  97.         02170 Espoo
  98.         Finland
  99.     and if you want to E-mail me, you can do so at: jopalast@freenet.hut.fi.
  100. I won't include Dave's address. To see that, look at the official Kingdom
  101. documentation.
  102.